home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1998 June / SGI Freeware 1998 June.iso / dist / fw_fileutils.idb / usr / freeware / catman / u_man / cat1 / dd.Z / dd
Text File  |  1998-05-21  |  4KB  |  134 lines
  1. /xlv1/freeware/1998.May/fileutils/3.16/fileutils-3.16.diffbuild/man
  2.  
  3.  
  4.  
  5.      DDDDDDDD((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         DDDDDDDD((((1111))))
  6.  
  7.  
  8.  
  9.      NNNNAAAAMMMMEEEE
  10.       dd - convert a file while copying it
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       dddddddd [--help] [--version] [if=file] [of=file] [ibs=bytes]
  14.       [obs=bytes] [bs=bytes] [cbs=bytes] [skip=blocks]
  15.       [seek=blocks]    [count=blocks]
  16.       [conv={ascii,ebcdic,ibm,block,unblock,lcase,ucase,swab,noerror,notrunc,
  17.       sync}]
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       This documentation is    no longer being    maintained and may be
  21.       inaccurate or    incomplete.  The Texinfo documentation is now
  22.       the authoritative source.
  23.  
  24.       This manual page documents the GNU version of    dddddddd.  dddddddd    copies
  25.       a file (from the standard input to the standard output, by
  26.       default) with    a user-selectable blocksize, while optionally
  27.       performing conversions on it.
  28.  
  29.     OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.       Numbers can be followed by a multiplier:
  31.       b=512, c=1, k=1024, w=2, xm=number m
  32.  
  33.       --_h_e_l_p
  34.            Print a usage message on    standard output    and exit
  35.            successfully.
  36.  
  37.       --_v_e_r_s_i_o_n
  38.            Print version information on standard output then exit
  39.            successfully.
  40.  
  41.       _i_f=_f_i_l_e
  42.            Read from _f_i_l_e instead of the standard input.
  43.  
  44.       _o_f=_f_i_l_e
  45.            Write to    _f_i_l_e instead of    the standard output.  Unless
  46.            _c_o_n_v=_n_o_t_r_u_n_c is given, truncate _f_i_l_e to the size
  47.            specified by _s_e_e_k= (0 bytes if _s_e_e_k= is not given).
  48.  
  49.       _i_b_s=_b_y_t_e_s
  50.            Read _b_y_t_e_s bytes    at a time.
  51.  
  52.       _o_b_s=_b_y_t_e_s
  53.            Write _b_y_t_e_s bytes at a time.
  54.  
  55.       _b_s=_b_y_t_e_s
  56.            Read and    write _b_y_t_e_s bytes at atime.  Override ibs and
  57.            obs.
  58.  
  59.       _c_b_s=_b_y_t_e_s
  60.            Convert _b_y_t_e_s bytes at a    time.
  61.  
  62.  
  63.  
  64.      Page 1                         (printed 5/18/98)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      DDDDDDDD((((1111))))         FFFFSSSSFFFF ((((GGGGNNNNUUUU FFFFiiiilllleeee UUUUttttiiiilllliiiittttiiiieeeessss))))         DDDDDDDD((((1111))))
  72.  
  73.  
  74.  
  75.       _s_k_i_p=_b_l_o_c_k_s
  76.            Skip _b_l_o_c_k_s ibs-sized blocks at start of    input.
  77.  
  78.       _s_e_e_k=_b_l_o_c_k_s
  79.            Skip _b_l_o_c_k_s obs-sized blocks at start of    output.
  80.  
  81.       _c_o_u_n_t=_b_l_o_c_k_s
  82.            Copy only _b_l_o_c_k_s    ibs-sized input    blocks.
  83.  
  84.       _c_o_n_v=_c_o_n_v_e_r_s_i_o_n[,_c_o_n_v_e_r_s_i_o_n...]
  85.            Convert the file    as specified by    the _c_o_n_v_e_r_s_i_o_n
  86.            arguments.
  87.            Conversions:
  88.  
  89.            ascii
  90.             Convert EBCDIC to ASCII.
  91.  
  92.            ebcdic
  93.             Convert ASCII to EBCDIC.
  94.  
  95.            ibm  Convert ASCII to alternate EBCDIC.
  96.  
  97.            block
  98.             Pad    newline-terminated records to size of cbs,
  99.             replacing newline with trailing spaces.
  100.  
  101.            unblock
  102.             Replace trailing spaces in cbs-sized block with
  103.             newline.
  104.  
  105.            lcase
  106.             Change uppercase characters    to lowercase.
  107.  
  108.            ucase
  109.             Change lowercase characters    to uppercase.
  110.  
  111.            swab Swap every pair of input bytes.  Unlike the    Unix
  112.             dd,    this works when    an odd number of bytes are
  113.             read.  If the input    file contains an odd number of
  114.             bytes, the last byte is simply copied (since there
  115.             is nothing to swap it with).
  116.  
  117.            noerror
  118.             Continue after read    errors.
  119.  
  120.            notrunc
  121.             Do not truncate the    output file.
  122.  
  123.            sync Pad    every input block to size of ibs with trailing
  124.             NULs.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.      Page 2                         (printed 5/18/98)
  131.  
  132.  
  133.  
  134.